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s comes to us by a kMig and draittous 
route through bulletin boards and 

and checked it out with its origlnatDr Michad WDIu, author of Applied 

ThetridiisuseluiifAppklllbrfcshangitMeyouh^ 
desktop. It doesn't ALVmSmK so don't depend on it Gomptete^iiTte 
routine iM devetoped 10 speed toting of the desktop espnida 
routine does imiK the onfir tMng you shoukl do is save 1^ 
working oa Then reboot AppkMbrks and rckMdy^ 

When AppleMbrks seems to hang, first for a few rnin^ 
Gomrnand you gaw was to remove or delete sornethin^ this can take aiiAiile 
on an expanded desktop. 

If nothing happens after a reasonable amount of time and you are 
convinced that AppleWorks is all twisted up in its own undemcan press 
Gontrokeset untO you break the knot and get into the Monitor. Reset will 
switch the screen to 40 columns and you will have an asterisk prompt on 
your screen. Then enter 



3 control 'P 



Mifct bank e on big i 
turn on 88-CoIuans 

th«n: 



or\i cards 



Note: If this doosn't put you In M-coluans, 

FFS% 

If you can i git Into 8«-eoiuans« you'll Havs to rsboot. 

2FI:2C 03 Ce 2C 83 Ce 4C 33 19 (Thost art tights, net btM.) 

zriG 

At this point you will be back to the AppldMorks rnain inenu Witt 
intact The chokes on the main menu may be numbered strangcl)^ if so. 
simply choose another menu (Add nieswiUdo)and escape back to the main 
menu. 

Remember, do nothing but save your files, ror safety sake save them ona 
different disk from the oneyou have been using-dontrlskdestroyfa^ 
most recent back-ups. Then reboot and rekMKL 

IteilpptelMnUacrOrai^mentkinedherelastAug^ 
moved to Colorada The goup maintains a deartng house of templates, 
notesr reviews, and pubttcKkNnain utilities for App^^ 
they have 28 disk sktes of stuff availabfe for $3 per fksppy (2 skies) or $7i^ 
per disk (5 skies). The group also supports a buDedn board In Denvv 
(30>756^5222)andisstaitinganApple«forksdi^ 
Tor more Infomiatkm. send a stamped, setfoddrcssed envek)pe to The 
AppleWorks User Group, P.O. Eto Denver, CO 80224. 

IHocron aad mmm m^^mi msm to AppMtafcs In Bea^ Bros' 
newest offisring, i^faooHbrflcs; by Randy Brandt ($34S5 from Beagfe Bros. 
3990 OM Town Ave, San Diego. 92U0). A "macro'' alkm you to enta 
kxig sbing of diaracters or keystroke oomniands ^ 



With JlacroHbrfca this singte keystroke is a combinatkm of the sottd-^^ 
key and Just about ariy of the other keys on the keyboard. 

Any sequence of keystrokes you enter so often as to be bothered by the 
kiea of having to type it is a good candkiate for maalficatfon. Your nme and 
address, the commands for printingadocument the keystrokes thi^ save all 
the files on the desktop, the kcg^rokes for inserting a new montti in a 
spreadsheet the kcysb^es for recording a dues payment from a member 
of your flash Rambler User Ckroup, the keystrokes for writing letto 
congressman., .the possiblides are endless. 

The package comes with a set of pre-defined macros. These are most 
useful in the wonH>rocessing nrKxlule but will work in any of the three 
AppleWorks programs. You can use some or all of these supplied macros 
and you can write your own. The ten number keys, throi^ 9, can be 
defiried and redefined whife you are using AppieWiKkSw These ten keys are 
aUowed macros of up to 70 keysbt)kes each. 

Naofosfor other keys must be defined ahead oftinK,usingan AppleWorks 
word processor file* and "compfled'' using the MacraHbrjicsprogi^nL These 
maom can be any length — the only Uniit h that all of them put togeth^ 
take up no more than 4X)95 bytes. One maao can call another. A macro can 
even cafl itself. An AppleWorks word processor starter file, hokiing the 
standard AfaooMbrfcs macros as well as comments and suggestions, is 
included in the package. 

PlaaolMunKXise support alkM you to use the mouse to select menu 
items and to move the cursor around the screen in any of the three 
AppleWorks modules. By hokiing dcwn the mouse button you can make tile 
screen scrolL 

A number of other udlity programs are inchided in the pockagc One 
alfows you to reinnrite the AppleWorks help screens. You can replsice 
ApplcWMfk's word processor-help saeen with a helpAil list of MaoMjuit^z 
buiK-in macros, or you can aeate screens to help you with your own nnaam, 
or your assembler's direcdves, or your fiunfly^s birthdates, or any other 
information you like. 

The mston of ProDOS supplied on this disk inchides a prog^ seS^^ 
called iSM's Better iSlefe; by Alan Bird, in piffi^ 
This is a beautifld littie piece of work, lillhen you ^ 
(from Applesoft you do thb with the BYE a)nnnand), Bfrd's quit aide gives 
you a list of the subdirectories and system programs on the cunent disk 
(rather than the standml crrrCR PRCnx rignnarofe). You can scr^ 
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the list and select the program ycHi Mnt to o 
Ifyou seleda subdirectoiy its contents will be displayed Ifyou press escape, 
the program switches to another volume ^ repeatedly pressing escape you 
can flip through all the volumes that are online The only limitation of this 
program is that it won't list or run Applesoft programs for you — it can only 
get you into system programs such as Baslcsystem. The big advantage it has 
compared to other program selectors, however, is that you don't have to 
configure it ahead of time—you can use it to find and slut any system 
program in any subdirectory your computer can access. 

/lacroHbrfcswortewith all but the eariiest versions of Appll^ 
and Owckmate Technology's desktop expansion software It does not 
h«wcver» work with Pinpoint It also doesn't support AC'S printer buffer (no 
M§ loss^software-based printer buffers have never done anything for me 
buteatn^ files). 

■eagle Bm seat aloH MM btmtiHstsU^d^ 
first 500 ffamMtorfs ngsiaian cards it received. 

Hr cmt if NacraUirki huutrs utlna: 

ltr|« mm carit gSS 

AppUti Cufinttrlnf Nft 

lit •ttmr in 
MriM 53k 

color aonltor 35> 

clock 3M 

UnlOith 3.5 m 

hard disM in 

Sldtr m 

all other m 

Early fUmWortm buyers are not repnsentaivc ef all Apple ewners. 
Nemtos ef ttiis group likely own more p^phmls than the average Apple 
user. However the proportions of periphery owned are probably indicaive 
of what is happening in the Apple world 

IWo numbers stand out first large memory cards are by Car the best 
setting peripherals on this list and Applied Engineering is by hr the 
dominant supplier, now you know how the company affords all those ads in 
the Apple magazines. 

Second, the UniDisk 3.5 has quickly achieved a greater penetration than 
all hard disks put together even though Apple's marketing wizards gave it 
the same name as their 5-1/4 inch drive, priced it about the same as a 10- 
niegabyte Sider, and have refused to fix its niajor bug, which makes t^ 
protection tab on 3.5 inch disks dangerous to use (January 1986, page 98). 
Apple has known about the bug since before the UniDisk was released M 
has gfven absolutely no indication that it intends to fix it 

The UniDisk 35 has managed to overcome Apple's bureauaatic naming, 
prkinf and updalini palkte only because it is a wonderful little device 
After using a oeuple ef Hiem fiar several menths I have te admit ttiey are 
^iet nified, and have leH ef capadty: 1 here^ take back all the snotty 
cemmenli I made abeut ttiese drives in teteber (pafe 73), altheugh I still 
think Apple was stupid for net buiMInf in i0S 33 suppert 

Hard drhffs have twe aiMtii|ai ever iie UniMsk - speed and maxima 
file size Their disadvantafts are that Ih^ are neisier less reHaUe, and yeu 
can't remove ttie disk. 

The speed advantage of hard disks is evaporating, however because of all 
tiiose RAM cards. A RAMdisk is ^ter tiian a hard disk, and, if backed up t>y 
batteries or an unintemiptable po%^r supply, just as reliable. This leaves 
hard disks witii Just one advantage - ttie ability to hold very large files. You'll 
see that advantage melt away during tiie next couple of years as RAM prices 
continue to foil (more slowly than in recent months, perhaps, because of the 
strenflh of tiie Japanese Yen, but fisill ttiey will). The fastest most reliable 
mass storage now available for the Apple II is a combination of an 
etedrk^fy^Mcked-up RAMdisk and a UniDisk 35. 

Unil recently RANdisks weren't widely used in ti)e Apple worid for two 
reasens. 9ne was expense The second Has ttiat nx)6t of tiie available RAM 
cards became RANdisks enly with the hclpof RAM-based sofbiore patches 
and addliens te the eperaMni ^stem Apfle «fushed the second problem 
last Call with the inlreduelien ef te RAN expansien carC whkh included a 
RANdisk driver In RON en tie card, i^iere ft eeuMn't be stepped en er 
otiieni^se destroyed. 

new Applied Eof^aecriBg has Jaet ghM aa ta g eifc i c beeel tm 
R/tfMleks witti its introduction of tiie Ramfactor card. This card uses a 
standard slot like Apple's. However it has twice as much RON as Apple's 
card, whkh iives its RANdisk many addiienal abilities. Uke a Skier hard 



It Is recognized as a sterage device by froBieS, BtS 3.3. fmrnL aai 
CP/M. Uke a Skier tiie device can be partitioned, with certain s e gn cntief 
the space alk)tted to each operating system. Witii one megabyte 6l memaiy 
and a $179 battei> backHip option, ttie card retails for $568, ex!2K% ttie same 
as a UniDisk 3.5; It can be expanded up to 16 megabytes. The battciy back- 
up option allege yeu ta lean files en the eard i^iik tie cemputar is 
off. 

1 tiiink ttie introduction of tills card mariis ttie peak of auxiliaiy^ 
schemes for adding memory to Apple lis ApplM Cngpneering has modi6ed 
its AppleWorks desktop expansion sofbtfare so ttnt it works Mtti RamTacfeor 
— ttiis software has been the nuyor reason for getting ATs auxfliaiy^ 
based card in tiie past (AC'S AppleWDrks desktop expander even works on 
an Apple ll-Ptus with RamPactor and an 80<olunui cardL The enl) 
disadvantage of ttie Ramf^r card is ttiat it require a standard slot 

TIK Ifc-A^ Color Noaitor iaterimm piaUeai 
11; April, page 2.23) made it to "read and posT santeneiBt iMus at 
Apple deaters as ef May I As mentioned here in Aprl the praklaa is a 
missing shield en seme He disk drives. Apple dealers are siwaaad li HMl 
a shield as a warranty transaction if your 11c is missing it ikt mm Wt/im 
says that He stod-afone power supplies witti date codes priir le laM (491 
week of 1984) may induce waviness in ttie color monitor. UpooningMii 
from Apple will tell your dealer how to get you a replaoement 

printing already, tiiough 1 Just found out about it (ttie copyright date is 19841 
Its by Robert C Brenner and is the first Apple repair guide for non- 
technidans ttiat I've run into. It has a great deal of general information on 
topics such as "Steps to Successful TroubleshoeHnf" ^IVhere ieee 
Interference Come FVom?, " and "Removing Solder ' 

But most importantty. it has page after page of very spedflc infonnation on 
exactiy which chips are suspect when your Apple suffers from various 
combinations of ill symptoms, Itgives very detailed, conservative instructions 
on how to proceed if you want to make your own repairs. Anyone with 
responsibility for several Apples who's willing to use a chip puller should own 
ttiis beek. it was published by Howard W Sams and Co and has a list prke of 
$19.95; yeu can get it by mail wrder from SC Sellware ( P.O. Box 2S03M. 
Dallas TX 75228 214-324^2i5t) fer $11 plus $2 shipping. 

Lael ia the private daaiaia, Has Apple ever released an Applesoft 
suppert padage for doub^e^tig1^egehllienflphics?g^^p|iif?nb^ 
Bruce Ristow points out that it has— hidden away on a disk ttiat came witti 
Apple's auxiliary^ RGB card, whkii is no kNiger sokl The package 
includes 18 ampersand commands for drawing and for printing 8(kx)lumn 
text in double-high-resolution. 

Also missing from Apple's most recent price lists is tiie DOS (3.3J 
Programmer's ToolMt now ttiat Apple is listening to user groups, pressure 
from ttie right people might pop ttiis stuff into ttie Roups' pubik: domain 
software libraries. Wittiout ttie pressure, ttie stuff is totally leet— if s iUefal te 
make copies and impossible to buy them. 

Apple DocuBM»tatioa Update: A new packet of technical notes was 
published by ttie Apple II technkal support team in early Nay Here are the 
new items for those of you whe want te update our Narch list ef Apple 
documentation (page 111): 

Ttchricil Notts- -January -April 1986 
ProOOS: 17 

He hardyiri: 1 througr* 6 

lie narbwari: 1 throuqr * 

n«Aorkj expansion card: 1 

S«tnptri iiPtttCil c^nvfrttr;: 1 t^rfcur 3 

JriDisN 3.5: 1 throuqTi 4 
(^Im II •isc: 1 inrougr £ 

Most of ttiese notes are pretty esoteric Appie II fUsceUancous Technical 
rtoCeO, however, raises a probiem at least a few Q pei i J^ pyle readers have 
probably run into. Apple has recently discovered a bug in ttie Pascal proto^ 
firmware on ttie Super Serial Card The bug surfoced ttie combination of 
Appk's Aooaae jf eemmunkations sofbiyare. ttie UnlDiik 55. and die Supe 
SoialCard. 

The preWem haa ta de with the ICMMCnr N9N spate that peripheral 
cards are suppeeed ta share. The hardware pat ef the preteoel is that each 
card sheuM turn eff its $CMi R*N whenever byte ICnr is aecessed and 
turn its $C80dR0N back en when its sleC^dependentlim space is accessed 
(slot-dependent RON is at $CsXX-each stot gets $100 bytes in ttie range 
from KlOO to $C7IT). The software part of ttie protocol is ttiat all uses of a 
card's $C800 RON sheuM be veaterad threugh the card's slet^ependent 



Downloaded from wwwApplezOnlinccom 



IMS 



iOn and that the finmiore on the canl should ti^ 
M»iK$C800area 
Iltt r»cal cntiy pdnts on the Super Serial (>d; ho%««^ 
ICBOO ROM without referencing $CnT. Apparentiy the t>ug hasn't 
flHiKiBd before because the Super Serial Card could overpoi^ 
CBiivtese ROM was still on. The UniDisk 33 card, however, uses tie s^ 
a^to '(felve the bus" as the Supa^ Serial Card, and ndther can ov^^ 

PMbI and aisembfy lanfuaie pr«f»T)s lhat intwid te use 
^piiM wHh frwip* •feards that iMiM indude Ihe Super SfM 
Aarid do so something like this: 

characttr out, tUtut rgquMt nmter, ttc. 
_ai aCs i*tl«t nuator tf nrtf (raqulrti by Htttl arvtry peint #r«ttMl ) 
^ M 

cm <«L^ nSLDT'STre. und tM^ inttrrupt r«utlnM tt fix ttMl RW 
51 i0Tf turn off all SC8M ROtt 

JS artr^t go to sntrtj point (thu turns ttw card'i SCBM ROtI back on) 

Sme Apple has promeM the Super Serial Caaf M a nioM 
pef% icvelepers sheuld uic ii4wn dni f i i ni flrmwe for siet-basei carfa, 
irs likely that many iMfei% eaNs share this bug. However, the more 
eammenlyHMd enky peM en the eard-the ene Applesoft progra 
-Mies $crrr at it li suppi ni la and deean't present a problem. The 
r^Meal entry poMi have seme advantafee fi»r assembly language pro- 
fannMrs hewcMi;and hn« been felMni mere use by devdepers reeen% 
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There are two situations in which it can be handy to get a list of all tiie 
variables a program is using and their current values. One is during program 
detNjgging. Scanning ttie values of a program's variables after a prepam- 
breaking error can be an immense help In finding tiie bug. 

The second is when trying to Rgure out how programs that use ProDOS 
VAR files work. Apple's new system utilities program, for example, makes 
heavy use ofVAR flies. Its very helpful to have an easy weyte find eut what 
vwiables are in such a file and what tiieir values are. 

There are a couple of commerk:al programs available ttiat as one element 
ef ttieir many abilities, can display current variables and their values. 0^^ 
leagle Bros' Doubte-7^ by Nark Simonsen ($34.95, 5990 Okl Town Ave, 
San iief»,CA92U0)and the other is (Men Breden's/>oCrfP($20,521 State 
Ri PrineetMt lU M5M). Theae are assembly lanfuafe p a^ mg es that are 
neatly hidden awey frem the Appleeeft prtframyeu are warking en. 

neither ef them ean dump the values in anays, heiwever. And neither ef 
them teaches us as much abeut A p ples oft as wriMng eur ewn variable reader 
would. 

As it happens, most of the background Information needed to write such a 
^ogram appeared in Qpen-^Pf^ in April, in tiie article about using 
Applesoft witti a RAMdisk (pages 2J7-2.21). Just for fun, lets buikl on ttiat 
article and write a program called VAR.READCR, ttiat will work under eittier 
DOS 53 or ProDOS. 

I've reprinted April's Figure 1 to Jog i^ur memoiy about Applesofts 
memory Applesoft progranis reskte in tiie area from $800 (2048) to $9600 
(58400) and are split into four nvyor parts— the program image itself, a 
table of simple variables, a table of array variables, and a string storage area 

The variable tables hoki the name of each variable and, in the case of 
numeric variables, tiie current value. Tor string variables, tiie table hoMs tiie 
tenftii of ttie string and a pointer aimed at the string Itself, which is usually 
stashed away somewhere inskie tiie string storage area 

Reading the variable tables sheuM be quite easy — all we have te do is scan 
them frem be|f nning te end, dig eut each variable's twHctter name, and talk 
Applesoft into displaying the eurrent value. 

Tor example, each item in the table of simple variables is seven bytes long. 
The first two bytes hokl the two letters of tiie variable's name. By u^ng a rOR 
loop witii a step of seven, you can scan tiie table from beginning to end, pull 
out all ttie variable names, and detennine what type each variable is. Then Its 
simply a matter of printing its value. 



Since Applesoft keeps tiie address of ttie tables in standard two-byte 
assembly language pointers (with ttie high byte last), lets begin by devising a 
two-byte PCCK function that will retum ttie value hekl in two-byte pobiters. 
How abeut 

377W Oer FN PK(flOR]=PEEK(flOfi)*PeE<(flOP*l)»256 

This statement defines a function you can call witti such syntax as V-fTI 
PK(X). or PRIPfrni PK(X), where X can be a number or a formula ttiat specifies 
ttie address of ttie first byte of ttie tiM>-fayte pointer you want to examine. 'The 
function returns the address stored in that twe^ peinter. (riete the 
diflerenee between the addreis ef the pointer, whkh is X in these examples, 
and the ad d r e s s the peinter is aimed at whkii the funetien returns.) tnce 
the PK funetien is defined, we can find the beginning and end ef the simple 
variable table and seen it like ttiis: 

37B11 TS^FN PK(18S] : RCn TS = tlapli varttbli ttblt's ttartlnf air 

37812 TC'FN PK(1«7)-1 : PCn Tt > t«bl«'t andlng adr 

37I2« FW m*15 Tl TC STCP 7 : KH scan 7'^t« tlipla \ariabln 

As we scan the table, vtant to find out ttie name and type of each 
variable Hrom April's article (page 119), we know ttiat combinations of high- 
and low-ASCII characters are used to designate v^hether a variable is fleating 
point integer, a string, or a function. 

To determine a variable's we can let T=0 as we start to examine it If 
ttie first character is high-ASCII, we'll add 1 to T If ttie second character is 
high-ASCII, well add 2 to T Thus, T will end up for kMow (fioating point), 1 
for high-low (functions), 2 for low-high (strings), and 5 for high-high 
(integers). Here's some definitions ttiat will allow us to turn T into ttie normal 
variable kientifier. They woukl appear at the beginning of our pro^pam, after 
the PK funetien definitien: 

37791 TVftf[l).- - : ICn rial 

37791 TVPE$(1)." : KH function 

37792 TYre$f2).*$- : ICB string 

37793 TVK:I(3)»'»- : BEM Intagar 

And here's a subroutine that actually digs eut ttie name and type ef the 

simple variable stored at ADR.: 

37961 RCR * Raad variabla naat and typt « 

37914 !«• 

37915 Cl=PtCK(«i*) : IF Ci>127 THEM T«T*X : n»Cl-12l 
379Sfi C2*reEK(^*l} : IF C2>127 THEN T-T+2 : C2*C2-12S 
37917 If C2«t THEN C2*I«C(- ') 

379M NS«IHM(Cl)^lHM(C2)tTVKS(T] 
379n KTURN 
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ftwn Aprift Tticie we also know that if a variable hM a wil liHii nuc; 
lhe jiii i » i iJ I « i to i ^bc#wm ^ 

a Iitai4i'*ltito is the rMMi inr hie tS7. noMBe llMlIf admotaruM ki hWh 
ASCII, we sut>tra(M m fom tt Thb rnikM il diK^ 

simplidty later on. 
Since mriCTWmhwcnawlucMindatidwIfc 

right away: 

Vm : tr T-i TWN MINT Ti^ictlan mfim^,' : ICKT 

Now we have captured the variable name in n$; all we have to ck) is print it 
and its associated value on the saeen. PRirrT 11$;' - '; will get the n^ne and 
an equal sign up on the screea but how to do we tell Appkaofttoprintlhe 
wrtue erf the wii^ is n$ r^ia thm the of 

In Lego Ihto to no probteta hM i lun^ 0^ 
the value of a variable specified by another variable 

rWE -X$ -Ct^roSCD''' Tht ftppltioft tquivaltnt is x$=-C»rLJSCO?' 

MftCE "MS -XI " It MS='X1- 

PRINT THING :NS (No appitsoft tqumitnt «u«ilat}U.} 

9fmtmmM Up MivAile iaiiie b af no signifkance an|haii-La|t 
has a biMn oommaml PWB (print out names), that prints out al active 
^viable names and their values. 

In Applesoft, there are two possibilities. We could poke the variable name 
somewhere in memory and then write an assembly language routine that 
would trick Applesoft into printing that value, or we could just poke the 
variable name right into a PRIMT statement in our program. 

When a program POK£s changes inio itself it becomes s0mot^yiiiQ. 
Most pnrfi^sionais disdain such pfayaww. That alanc li y tab a fc l y ra aaan 
enough to Ipve out how to do it 

Apk ttie April iiaue (pa|e ZU) haa al the Mliiniiifiiveniad la IN i 
spedfk spot inside a pioiranL to aaample, M aqr the Hne we 
wanted to modify loaM lie Ma: 

The idea would be to overwrite the XX$ with the name of the variable we 
really want to print (At the moment the name of that variable is stored in ri$. ) 

What we need is a subroutine that returns the beginning and ending 
memory addresses of any line in memory In April we learned that the first 
iMa lytes of each program line, as they exist in memory, point to the next 
piafim line. The thkd arid iMffth byles hokl 
lne, A pfliai ft almaapa l n ti ra ala d Tmi«(mitt^ 
Irat Ine af Ihe piapant The laat noirlint paMv haMi laraai ThuK 

3799t fiCn • rind lint n^jHtour I • 

37994 Aa'FN PK(lt3] : R£R addrttt of currant lint, lt3«TXTTRe 

37995 rtt^FN PK(«a) : RCH addrttt of ntxt tint 

37996 IF PHL=« THtM PRINT 'Thtrt't no tint 'iL;- in this progra..- : STOP 

mv IF L«ni PK(ML42) im mrm 

37998 flCL«^ : 8010 3W95 

Line 994 gets the address of the first program line out of TXTTAB. Line 995 
im ihe aMm of lie aaoond profptm line out of the flrit one. Une 996 
leeto la aae If we^ la a ii a l lie and af the program; Vae, we prtnl anirrar 
message and braak Ik program with STOP. Un<<*^"' ^ oseelfMielne 
number embedded In fhecimnt program line f looking for. If 

not we make the next program tine the current one and start over 

This subroutine returns with the actual memoiy address of the specified 
line in ACL and the address of the following line in ATIL In our current 
situation, the three bytes we want to change appear at the end of a I in& Th us 
it's easiest to poke the changes in a fiew tiytes below ATIL 

now lets pik all this stuff logetho in one ptee-- here's the ei^e kxsp to 
d iggi ng up the iimpte variabk Mrie. Nate hew Ine m b madM ^ 
823: 

37619 PEH * Dlsplitj naats and valuta of all siaplt varlablM * 

37611 TS=FN PK(US] : RCN T5 = fliapla variable tablt't starUni t** 

37612 TE«fN PK(U7M : REM IE » t«bit i tnding adr 

Wm LnWm i 9mM Wm : m pa Mm lint L in NIL vri Ml 

Mt rm MINTS T| TC STV 7 : W Mm 7-tout9 tliplt MrlaklM 
3PII1 : IHUi Jnm : m ftt rmm and typa mf thlt v«rt«iU 

wm i ir tpi vm mm Tmti«i mtMr : ma 
mm $ m i-t Ti 3 1 mi iM.-5*Miic(Niit(Mi.Mn : nbct 

3M»4 : MINT W;' > *:)M 

3PHi ma 



riowttiatiichavettieMmplevrtMaalBlMiireaCM^ 
af yraMa m s the a^ay wria b la a paac. As I laM aartiat ndthcr af the Iwa 

commeri ca l packages nwn toi c d dapliQf the %akm of anay wMes, 
although Bredon's does report the diniensions of all active arrays. 

Admittedly, dumping the an^y variables is more difficult than dumping the 
simple variables. The problem is that arrays have no set number of 
dimensions and no set number of elements per dimension. Any routine we 
write has to be quite flexible 

On the other hand, however one advantage of working with anrays is that 
you can put most of an anray variable's name in a second variable Tor 
example, if A= 1 and B= 2, you can print the anay demsit XX$( 12) with the 
statement PRir!TXX$(A,B). 

Aoplaaaft stoica a pointer to the bqiMng of the amy vwlab^ 
AR)rMi(l6ai07)and pointsJustpastMhere the MIe ends with ST1«1D 
($6D, 109), so finding the table is no trout)le However, as we saw in April, the 
an^ table keeps getting moved to higher and higher addresses as new 
simple variables are used. Tor each new simple variable, Applesoft has to 
make room in the simple variable table To do this* the array variable table 
has to be moved 

Thus, before we bother to determine exactly where the amy table is^ its 
important that we activate all tht simple variables that our am|MuMping 
rou^ wtti uae % anaaking a kx)k ahea4 1 know 1^ thcyi kc; aa ta 
how to fcid tic anay tifcle (nale that Its nat naocaaaiy la rmlMk lie 
simple variaUaaiiathai«alr«a^ba«iuaaitodumpttieslmptevartaMe 
table): 

V912 MKN M(1M) : MH ftfrty Ukla's tUrt It NiRt Variabla 
3^13 TC-m M(1M) : MN tatoU't miin§ nmnn 

Unlike simple variables, which are always exactiy seven bytes kxig. anray 
variables can be Just about any lengtii. It depends hm many dimenskxis tiie 
array has and how many elements are in each dinoension. 

r^^^^i »pntiy, the tiiird and fourtii bytes of each an^ \atAt entry hoW ttie 
distance to the next array variable entry. (The first two bytes hold tiie 
variable's name In ttie hlgh/lw^SQi Gode we ve oome to expect) Line 922 
uaasm topoM atiievariMe eunm^bti^ on and adwnia TfV 
to point at the next variable 

3792« IF NV=TE T^CN E«) : REH k/>tn ihitrt'a nc Nt*: wa';aCit. xit 
37922 flOR=NV : NV««Ofi ♦ FN PK(fiO(!»2) : REW working pcm'.tr floft 
37924 GOSUe 379W : RCn git ntm and of v»r;a6it a: flOfi 

\buli find the number of dlmenskm In an anay stored four bytes beyond 
the start of ti>e array's entry. Since nxKt arrays have five or Sewer dn^nsi^ 
and since our dump routine s complexity increases with each dimension we 
support let s skip arrays with mare than the di m analana, auah aa 

mm ND#iec(MlMl : m gtt IMfew of Olmlont for tHit »trw4 

37322 IF «)>5 T^CN PRINT -flrriy -;N»;- hii fli«tn«ions.- : GOTO 37g2t 

rkiH consider for a moment the line we'U use to actual^ print an arrai^s 
value Again, because IVe ihaaiad and leakad abaai I know it wl ga 

soiTi^ifig like tills: 

3WM mm NiU);NJ(2);N»t3);N$(4j;N$tS];-) = ';xxi[fl,B,C.O.C) 

Of coum; wel haK to awmfte IlK JM at iie and af M 
Liu,: :,>'tiTe amy i« are ait ia% wailiii|an,an<wcl have toov^^ 
( A,B,C,D,C) with the cxaet numbar af i mma l am we have. 1^ example if we 
have a twcxlimenaian amy namad PA%. afkor ovmffilin|llne 97t It shauM 

look like tiiis: 

;:::: MINT NI(l):Ni(2):HI(3);NI(4);ia(S):') - ';Mft(M ) 

That should be easy enough. Line 914 finds the addresses we need for 
poking changes into line 970, line 940 pokes in the variable's name and 
Hnaa MlMf phig In ailhaf Hanks af cianuTiaa and laltors: 

mi4 imwm : wmm wm : w fit ml mm. tr iim wm 
wm raiM Ti 3 : «M.-u«i.MC(HiM(Ni.i,i)) : mn 

W941 Ut-MI(3l) : K»-MtOI) : MK Mvk mmm 

wm ir M>4 rm aii*',' : mux* 

37943 POKE fiHL-4.«SC(0H) : POKE flHL-3.ftSC(02f J 

37944 IF «>3 TfCN Dl»»".- : DPS-'O' 

37945 POKE Mt.-fi,f^(OiSj : PQKC fM.-$,ASC(0»] 

wm tr M>2 ncN 11$--.- : Nf--c- 



JaelfM 

37947 mc ML-l,MC(eiS) : MNC MC-7«W(l2t) 

37946 IF NB>1 THEM 01f»%- : B2».-l- 

37949 POKE PNL-1«.ASC(D1S] : POKE fM.-9.ASC(D2S) 

Mow its a simple matter of finding out how many elements each 
mension has and txilldinga loop that will step through each element The 
number of elements in each dimension is stored beginning at byte 5 of the 
amy toaiptkm. The final dimension is stored first And believe it or not 
ttMK lw»lylc numbtrs are stend higi-lyte first- btikwvds frem the 
bMkwvd nwttwd uiually uiii. [^s««IMIIie numlNr iftlminlilntKh^ 
dimension in our own Ulie amy, K ): 

379S« FOR Ul TO NO 

37952 0(n-PEEK(fll«+3+(I»2))»256 ♦ FEE»C(«ii*4*tI«2) ) 
37954 NEXT 

The feKl that we don't Imow how many dimensions the anray has poses a 
few problems in building a loop to print the array elements, but IF 
MmmH wn lit artund Ihim: 

379II m 1*1 Tl 5 : MI(I]." : »«KT : KB clMr W() irrty 
3r961 rm »M it KND-I : NI(1J-«I*-(-*5TI»(«) 
jnm : IF Ni>l THEN FM Tl : NI(2)*'.%STtf (I) 

37911 :: IF Nl>2 nCM Fit C«« Tl •(l»-2)-l : m(3).%''*ST»$(C) 

37964 ::: IF >*>3 TI«N FP fi* Ti ItW-lJ-l : HI(4)«\'*STt»(l) 

37965 :::: IF »fli>4 TWN FM Tt •(W-4)-l : Ni(S)*% VSTtSfE) 
jnH ::::: ntINT NIU):NI(2):Nit3l:W(4};W(S);*) « -;lteS[K J,C*I,C) 
3757S IF »«i>4 TrtM «a 

37976 ::: IF «>3 TICN ICXT 

37977 :: IF W>2 THEN «XT 
37971 : IF M^l nCN »CXT 

37979 ICXT : IITI 379M: «N dt nwt ■ntry in array taklt 

So much for dumping anays. 

The reason this program has numbers in the 37700-37999 range is that if 
you use it to debug your own programs youll want it stowed away where it 
won't inteifere with the program you're working on. The easiest way to 
proceed is to ^VAIU^CADCR into a word processor (the complete llaiing 
follows this aitkk) and then save it in a text (Be. When you need it to help 
debug a pro-am you are worMng oa EXEC it in while the program you are 
woridng on loaded. Then RUM your program until it crashes (or install a 
STOP comnriand to break it where you think you're having value trouble) and 
enter QQffQ 37700. (Don't RUn 3770Q; that wiU dear all yow variables.) 
WUCAiCR wll than gve ywj a Hat af aU ywr iMlte 
values. 

If you want te riai a Pr«iW flc rac in VUUUAiCIl im 
riSTCNV pathname. Thb will iMi tie \M flk in^ 
QeTO377itandiiefMew!nbeli9taClfywi'dll(eaprintadaap^JuBt 

PRn or whatever first If yau want ta dump the listing to a fic put OPCri and 
WRITE commands in lino 3770^37702 and add a CLOSE command before 
the EMD in line 37920. 

To test the program, I recommend you take a k)ok at the VAR files on 
Apple's PtoDOS System Utilities disks. They are immense. Among ottier 
things, they contain all the menus that appear in the system utilities 
program. The advantage of using VAR files like this is ttiat if you want to 
translate a program into anotiier (human) language, all you have to change 
is die VAR fDe. The program itself can remain untouched. 

Incklentally, creating a VSMl fite is simple. Use a word processor to create 
list of variables and values that kx)ks Just like ttK one VAR.READER prints. At 
die top put ttie command (lEW At the bottom put the command STORE 
^aifinam& Save aU this in a text file, then EXEC it into menxxy "nie EMC 1^ 
vaate a new \ARfIlewitti all the variables and values in your list 

UMIREADER has one signiftaant problem. It damages the values in 
variaMat that have the same name as the varlabka it ItMlf usaa. This b a 
diraat aansaytanae af Hi baing written In A ppl aaa ft ralhar than aaaemWy 
language. As9eniblylan|Ma|ew»uM also be foster and aauMb^ 

tranapmnt On the ottier hand, fewar Op^^MP^ 

fol k]%v die fogk of ttie program, it wvuM baaame taa teng t» pKnt ham, and K 

would take too fong to write. 

We can get around die problem by inserting a section at the beginning of 
the program that k>oks for any pre-existing variables that have the same 
names as the ones well be using. Ifwe find any we can print out tiieir values 
before we tread all over them. IWo kmg lines of dashes can be used to 
separate tiiese from die otiier variables - if notiiing appears between die 
lines you know ttiat there are no variabte'iiame conflkts. I've included lines 
37710 ttirough 37789 in ttie final program listing to take care of ttiis 
problm. If you are fix»d witti typing in ttie pro^rant you GOuM 



lines out and cut ytur typing time in half if yau are pitparad ta daal whh ttie 

consequences. 

lfyoutypeinVARJ<EAiERandfiUnH(n«tttKnarmalaparittngprMad^ 

here's what youH see 



Functlan PK ritflnai. 

m > 527i 

I » 4 

TS • S263 ^ 

It « S297 

• (•) « • 

• tu • u 

• (2) * • 

(27 aort lints of «rriy varlitoltt fsU«u) 

Note ttiat sinae we startad ttic pragram witti RUn, tttaaeare aU variaMaa 
uaadhyWlREAiER ItKlf. #nly ttme simple variabita activated ttiroi^ 
line 37tl2 shawup in ttie diaplay-IInc 37tl2is where tiie end of ttie sim^ 
variable table is pinned down. Simple variables activated after ttial aitti i 
listed. 

Unfortunately, lines 37740 tiirough 37762 activate all ttie program's array 
variables-ttiey show up cvciy time. Whan aitamining variaUat, dan't gat 
VAR.READER's mixed up witti your own. 

Just for fun, enter enter QOTO 37700 immediatety after RUMning 
VAR.READEa How all of VAKREADER's variables show up between ttie two 
dashed lines - ttie values shown witti ttiem are left over from ttie RUM. When 
ttiese same variables appear a/ter ttie second dashed line, ttie values shown 
are those of the current trod. 

Here's ttie complete listinf 


• : VM.ICWCR 

• : 

• : ky Tw Hilahttr 
« 19K 

i ; 

• : • public iWMin prtfru 



377M KF FN KfMR]-fKK(WI()+PKK(Win)*2S6 
37795 PCM LlnM 37711 tm 377t9 aptltnal. Mt ttxt 

377U PRINT - - 

37711 IF fl >• T«N PfiINT 'fi = -;fl 

37712 IF B >• THEN PRINT = -;B 

37713 IF C >• THEN PRINT "C * -;C 

37714 IF >• TWN PRINT '0 = 

37715 IF E >• T«N PRINT "E = -;E 
3771G IF I >• ItfM PRINT *! = •;! 

37717 IF L >t TtCN WINT 1 « ";L 

37718 IF T >• THEN WINT "T - ^T 

3772« IF Cl>« THEN PRINT 'CI = -;C1 

37722 IF C2>« THEN PRINT "02 = ':Z2 

37722 IF THEN PRINT "NO = 

37723 IF NV>« THEN PRINT 'NV = -;NV 

37724 IF TE>t THEN PRINT "TE » ME 

37725 IF TS>« THEN PRINT "TS = -;T5 

37726 IF flC>« T«N PRINT -flC - ';f€ 

37727 IF flO>« THEN PRINT 'flO » ';flO 

37728 IF AlO« TJCN PRINT -flN » -:flN 

37738 IF LEN(D11)>8 THEN PRINT 'OH = -;01$ 

37731 IF LEN(02$)>8 THEN PRINT -02J « ':d2% 

37732 IF LEN(NI) ># THEN PRINT 'H% » -;MI 

37748 F88 1*1 T8 S 

37741 : IF 8(1) > 8 THEN PtIMT It";!;') « ';8tl) 

37742 NEXT 

37758 FOR I»l TO S 

37751 : IF LENtH»{I)) > 8 T«N PRINT "NI(-;I;-) « -;NS(I) 

37752 >CXT 

377G8 F8« 1*8 T8 3 

37761 : IF LEN(TY*(I)) > 8 THEN «IINT -TVtC;!;-) * *;TVf(I] 

37762 YCXT 

37789 PRINT " 

37798 TYPEJ(8) = - ' : REM ml 
37791 TYPEf(l)«" : HEN frf«tl«n 



2M OpenApple 
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Ask 

(orM) 

Unfile 
DOS 



I have an Apple lie with an external disk lie and a 
UniDisK 33. I'm considering tniyinga second UnlDisk 
and [\AK>nderedtfl flMiMiiKallhneflfiny€Nki 
drives at once 

DoyouluKiwofanyway to use the UniDisK ^5with 
CP/M? I purchased Nordic Softharc's />D/U(Dcccmt)er 
1985, page 93), and it makes the 33 inch drives worii 
teiTiftnUy with D0S33. Is aaything like that available 
farCf/H? 

Laird Natamed 

On an ApfAt lie up to two UniDisk 3.5s and a 
single 5- 1/4 inch drive can be daisy<halned together. 
The 5-1/4 inch drive must be at the end the chain. 
The UnlDisk 3.5s act as if they are connected to slot 
5, the 5- 1/4 tndi drive appears to be in slot 6, drive 2. 

Unfortunately, this doesn't work on the lie. The 
problem is that unUke the case of the lie there could 
Mre9^ be a 5-1/4 inch drive aOuMlyoonncct/edUi 
3MC *to2 eanM«ii»% lhe(JtaMlt3L5i»Mir 



Applied Cngineerfns is reportedly working on a 
UniDmX5Mmrf»me(F/H work-alike it provides 
with Its 1-80 fmnMM, I tfonl know of any other 
work in progress along I 
readers can he^). 



UniiWclStiiet 



Is there a software command to cause a UniDisk 
33 drive to eject the disk? I have a UniDisk 33 and 
«n very happy with it I think one advantage it has 
mr hard d^itteMitisiiniplar both ded^^ 
m wmnmmaKjf wnm miiMi MM vuMrane to 
biwktem. mm LOTS fMK 

Sl^4ien Bsch 

ScG^llcVi. 

Yes. there is a Smartport 'or protocol converter " 
call for ejecting a 33 inch disfc. Some month soon 
we re gokig lo foolc at tfie pmtoool oonuerter in 
^tMLkUtlht^$0%m^tm$n^9^m\n1ii^up 
mt1iihm»youhewtodothMfi0(imm 

im Wm Ejict 3.5 inch UniOiik " 
at 9ir-S : MIVC>1 

121 G»>'3M:2t M H M M N M U it' : IM SM 

m m-imim it ii r m m m m m- : mui sm 

m pmL 771. %M\*m : m cti«t u ok 

131 PtC MM : m irlw ts I3II 

i5« im-wi?isi 
lei IF im m 

iGi IF EPP=39 net mm: tj.ct f»*w.- t M 

1G2 IF Z9R-,49 TNBI PilMT ^ tfp^lw ircM.' : m 

1£3 PfilKT -£pror in tjtct lilting.- : EIC 

SM MM Lm tachniqua. space btfora irxJ ifttr N 
511 CM ^ - N iHK' 

511 rOI Ui Tl L»l(ll) 

512 : M 511«U W(NIM(I».I«1)]^UI 
514 NRT 

521 WC 72.4 : MJ. -144 
531 KTUM 



Theaboue program is for m m mmi dtf on purposes 
mmtlli:aBwrmmlt'sprettysk)ux'nH>seofyouwho 
wM more woutd probably like to see the 
^mNj/ iariguage aMe flNMM In Me prafiam 

-and here it is: 



EJECT 

3##:2f 10 CS JSR 01SP«TO 
3t3:»4 .DA 84 

y^:m 93 .OA DOLIST 
396:B0 11 93 STA ERA 
3W:69 RTS 



39A:93 
366:91 
39C:9F 93 
39C:*4 



3er:ii m 



311:99 



CFCLIST 
.OA 83 
.DA 81 

.OA CTflLIST 

,m 94 

WTUIST 

Mmm 

ERR 

.OA m 



COMtnd 4, control* 
Idr COMtnO list 
ttCt trror COda 

UfO'nO •*-'-or) 

8 of .taas ;r> c«OJ itt 
uM 2 for an^ 2 
*^ of control list 
Mi 4. tjKt iitk 

9 tf CmiST bvtM 



H whUh ii 5 on Me M ho uw m yiii m rmHif 
m9pm4 miMUbyvaMr^lhevtlmln$mn: 

adtkng&metot ar¥l mbig U a§ an iniupwn 
$CsO0. Without adding three. indMi^ i^lfK 

the card's ProDOS entry point 

Ifanerroroccurs, thecarrywUl be set and the error 
number wm be in the A register. If there is no error, 
the carry will be dear and A wUl hold zero. The 
important error codes to watch for are $2 7, FAIIJUHE 
70 EJEa. and $26. nO DCV7CC COmEOTD. Most 
other possible errors are related to invalid command 
tables. Apple's documentation doesn't say what 
couldcausearAlLUf<ETOEMCTerrororwhaito4o 
about it if it happens. 

The 4eite mtmt& In me 9mmani M aoutf 
Iheofdicii^ be aonwIMIi^ atfier lhan afie f9r 0riue 



V792 TyPE$(2) = 'S- : REM ttring 
37793 TyPES(3] = n' : REH mttgtr 

37619 R£n > OispUtj naMs and valutt of all si«plt varitolts * 
37811 TS=FN PK(195] : RCn IS = si^ls vaniblt tablt'o vUrtlni 
37612 TE=fN PKll97)-i : REM TE = tablt's onding tdr 
37tl3 L«3W4 : 9aUi Vm : MN put tMrtm 9f ilm I in WL ir4 Ml 

Vm rm M»»TS re TC STIP 7 : mm m 7-^|tt n^lt vtriaklM 
37111 : mam : m fit mm mi •r tUlt vtrlaklt 

37822 : IF T = l THEN PRINT -FjrxUon dtflnM.' : NEXT 

37823 : FOR 1=1 TO 3 : POKE All-5*l,«(mii(H»,I.lJ) I NKT 

37824 : PRINT NS;' * ';XX$ 
37125 l«a 

37S19 REn * Display naatt and valuts of all arra^ v/ariabln * 
37911 A=9 : 8=9 : C=9 : 0-9 : E=9 : «=9 : HV=9 : Dl$=" : 02S«" 
3P912 PK{197) : ROt array Ukla't surt l« Nwt Varltblt 

37913 tt-TN P«({199) : REM tablt's andlng ^Orwm 

37914 L=379?9 : GOSUB 37999 : REH gat Aa and RNL of Una 37979 

37929 IF NV=TE T^N END : REH yhan thart't no Naxt Variable, quit 
37922 AOR=NV : NV=AOR * FN PK(A0R*2) : RCR yorklng pointar is AOR 
37924 GOSue 37989 : RCn gat nana and ti^ of varitbla at AOR 

ym$ lO-m(|AOM) : m «at Nualwr of Blamlone for thla array 

37932 IF N0>5 T^CN PRINT "Array ^NS;' has -;N0:- diaanaiona.- : NTB W$ 

37949 FOR 1=1 TO 3 : POKE ANL-l$*I,ftSC(HIOt(H$a.l) J : tCXT 

37941 01»-Cmt[3l) t iM«lt3i1 : m hlmk apasM 

37942 IF IC>4 TrtN Dll'".- : 02*="^ 

3^3 POKE AK-4,ASC(Dlf ) : POKE ANL-3.ASC(Kf ) 

37944 IF l«>3 THEN 01»»'.' : 024= '0* 

37945 POKE Alt-6,ASC(0H) : POKE ANL-5.ASC(8«) 

37946 IF W)>2 T»£N DH=-.- : 02%''Z- 

37947 POKE AN.-B.A5C(0H) : POKE ANL-7,«tl») 
37946 IF «]0l T»CN Oil*-,- : D2S=-S- 

37949 NNC fM.-19.MC(BlS) : WC ML.9.MC(KS) 



37959 FOR Ul TO NO 

3?^ D(I}«P£D((A0R*3*(I*2)}«2S6 * PfUii(ai***[l»2)\ 
3nS4 ICKT 

37999 r« t>l n 5 : m{l\»" I ma tm clttr wo array 
V%X FM M Tl ${m)'i : NI(1)N«|4*(V$TIII(II) 
3mt : IF I«>1 THW mi n KW-D-l : M9(2)--.-t$m(|) 
:: IF iai>2 TN9I rW C4 T8 B(ia-2)-l : N9(3)-\%STII9(C) 
37964 ::: IF l«>3 n«N FW Tl IfWOI-l : M(4)-'.%STin(|) 
3mfiS :::: IF *ai>4 T»«l FM C-l Tl l(M'4)-l : Nl(5)>-. VSTM(C) 
37979 ::::: PRINT N$(l] :N$(2);N9(3):N9(4);N9(5):*) * 't)9«(A,|.C,I.C} 

37975 :::: IF l«>4 T«N fCX^ 

37976 ::: IF N0>3 THEN tCXT 

37977 :: IF ND>2 TKN NEXT 

37978 : IF «>i TMtN NEXT 

379f9 MB(T : MTI 3^11: W ia nsHt antry in array tatola 

37969 REN * Raad variable naae and ii0m * 

37961 REN • T«variable type • 

37962 REN • NNwtrlitoli tmm • 

37963 REH 

wm T*i 

vm ci>W((m) : IF ci>ur rm uui : CKi^iai 

3niC K-W(MIKl) : IF tf>Uy TW T«T«2 : MI-UI 
3W IF M TI«N ') 
mm NI>0«l(Cl)«««I(K)*Tmi{T) 

37999 Id • Fl9iri Un9 ru*9f I * 

37991 REN • WL-ai9rm of aurrvtt Una • 

37992 REN • AW. a<<raaa af rmt Urn • 

37993 REN 

37994 Aa-TN PK(193) : REN addrtte of currant lin«, IM-TXTTH 

37995 ANL-FN PK(Aa) : REN address of rmi iim 

37996 IF AN.*f THEN PRINT "There • no Una ';L;' In thla prarM.' : STV 

37997 IF L»FN PKIICL^ZJ THEN RETUHW 

jmna wl^m, : mti 37991 



jiiMi9e6 



Opcm-Appk 2^9 



1 andtujofor Drive 2 if other protocol corwerter 
<kvkX5wmdalsi^<i\abwdbtl>etweatth^ 
and the drives. DeterrrMng the actuM<kvkx number 
of each drbx from within a prog^ is fabiycompU- 
cated, however. Yet the ProDOS entry point on the 
UniDisk 5.5 card uses slot and drive parameters 
raiher than a device numl)er; the card figures it aU 
out somehow Doesn't it seem Wee ProDOS itseif 
shoM support an t^ct-disk command? At the 
moment however, aU the ProDOS tonet can teU a 
dette to (k) fs to read tOTite, report Its stato 
ANTnat itself. 

ASai Express V4i0 

I have version 4.20 of ASa/ &9>res& I am using an 
enhanced lie and I chose the "Apple lie" selection for 
a "local console" when installing the program. It 
MKuks at 1200 t>aud with no problems, contrary to 
your advice in April ( page 125). Naytx the diredKe to 
choose "Auto" or "Pascal U" applies to earlier 
versions. 

James WPatton 
Uttteton^Cok). 

77ie uersion of ASGI Express / use aroumf here 
atso saifs it's 4.20, tNit / su)ear / had to abandon the 
lie local console option to gft it to wori( on an 
enhanced lie. Prom your information it would 
appear the publisher has altered the program to 
supportbothoidanariewlleswithoutchangingthe 
version rmmber. 

One would tMnk that software companies would 
useanewversionnumberwhentheyaltersoftwart, 
Whai'sthesenseofhavingversionlDnumbersinthe 
first place if you can't tell different versions apart 
with them? Stm one has to applaud Ote fact that at 
least the publisher of ^SCU Express appears to be 
trying to Iteep the program up-itxlate. 

Dennis Doms, who wrote the answer to the AprU 
letter, says to mention that there 's one anomaly he 
forgot to mention that appears even after you follow 
the setup he recommended. It's that the cursor tends 
to leap around the screen durir^ protocol transfers 
(tMs may also have been corrected in your version). 
Dennis says this is disconcerting, but doesn't seem 
toaffecttfKflktran^er. 

finally, on the "undocumented feature " front 
Oifert^Mppk subscriber John Morse reports that 
ASCU tJ^rnaa can operate at a maximum 9600 
baud with a Super Serial card -not 4600 baud. Just 
select "8 " from the "baud rate" menu AitfH)ugh 8 
doesn't acto%<v)pear as a seiection on the menu, 
AEwillacceptitandwillproceedtorunquitehappily 
atSeOObaud. This seems to worit on both the DOS 
and ProDOS uersions. 

ProDOS compilers 

Any more news on ProDOS compilers? 

Roberto Heidreth 
Rochester. P1.Y. 

While calling around in search of a ProDOS-based 
Applesoflcompiler,wehadaninterestSngconversatlon 
with Tbm Bums at Foger yitigner Publishing, publish- 
ers of the SpeedSUur DOS 5.5-based Applesoft 
compiler. Tbm said that at this time, he icnew of no 
commercially available ProDOS-based compiler for 
Applesoft tie also told us Roger Wagner Publishing 
had no plans to produce one. and gave us their 
reasons, 

1} ProDOS is so much faster than DOS 5.5 in disli 
operations that use of ProDOS and BA^CSYSTEM, in 



itself, can speed upprogramssign^icantly. Therefore, 
there is less incentive for the use (4 a compiler. 

2) Compilers, at the time they were introduced, 
were the easiest way of speeding up Applesoft 
programs. Programming sophistication has now 
produced machine language tools, whidt can be 
accessed from Applesoft programs, that provide 
much of the speed of compilers. In addition, these 
ampersand utHites" and ^ProDOSadded commands " 
use much less memory than compiled code (DOS 
5.5 Applesoft compilers greatly expand programs as 
they are compiiedh are faster, and do not hamper 
development (the Applesoft program can still be 
debugged itrteractlveiy, whereas use of a compiler 
necessitates re<ompilation after eveqf change). 

5) DOS 5.5 Applesoft compliers were not big 
sellers. Given the additional reasons for not using a 
compiler with ProDOS, a ProDOS compiler would 
probably be a money-loser rather than money- 
maker. 

The only remaining feature a compiler provides is 
protection against having the program USTed and 
modified by the user. Of course, half the world thinks 
UST protection is a bad idea, anyhow At the moment 
it appears the other half wiU have to come up with 
some protectk>n sdteme o^r Uian compUMm in 
the ProDOS worid. 




Black tape 

Why are the ventilation slots on the Disk II covered 
(from the inside) by black tape? 

Harvey S. Picker 
Hartford, Conn. 

My guess is that The Disk II doesn't genera 
enoughheattoneedventil3^tion.Appleprobablyput 
the slots there to make Oie appearance of the drives 
matx^Uie Apple II and then added the tape to keep 
dust and dirt out 

C heap color 

I suppose everybody else in the world already 
knows this, but on the o*f<hance that they don't You 
can use your color TV as a cobr monitor for the Apple 
if you have a video cassette recorder. Simply run a 
standard cable from the monitor jack on the Apple to 
the video-in jack on your Beta or VHS. 

I use a two^ splitter from Radio Shack so that I 
can use both the monochrome monitor to read the 
text and the TV to see the pretty coknrs. (I use this 
double-combination for playing adventure games 
with graphics, mostly.) 

Douglas Cuff 
St John's, newfoundland 

t didn 't know that, I have heard people complain in 
the past that they couldn't record Apple colors on a 
tndeo cassette with this trick, so I assumed it wouldn 't 
work. Sounds tike it does work, however, on at least 
some machines. 

People whose goal is to get fuli<oior Apple screen 
displays on video tape and who find this trick doesn 't 
uK>rk should try running the Apple's video signal 
through an HF modulator (the standard way of 
getting Apple video to a TV) and then to the antenna 
inputs on the VCR IWio krm)s, it might work. 



INPUT under EXEC 

Here's a couple of tricks to liven up your readers' 
DOS 33 EXEC routines, lype this as a threHine text 
file, and then EXEC it 

POKE 118.1 : POKE 43699.9 : r*njT *ENTtR 

fiLE MftrC: -;rs : POKE 43699,1 

noNico 

POKE 118.1 : POKE 51.» : PRINT CHW(4):-0PEM-;r» 

The first line puts EXEC in deferred mode so that 
keyboard input can be requested by an EXEC routine 
(this trick was dssyibed by Bob Schmkit in HMirq^ 
Apple PimchV9S5). 

The last line persuades DOS that a BASIC program 
is running, so it will accept commands that normally 
cannot be executed in immediate mode. These are 
the same POKES that are part of your instructkMis for 
using DOS from assemb^ language in The DOST^ 
5cn^phoo«c (pages 129-130). 

I'm not sure that either of these is of earth-shaking 
importance, but it's nice to know you can do them H 
you want to. 

On the subject of memory location 51 which 
contains the prompt character for keyboard input - 
in immediate mode, it contains 221 the right bracket 
prompt for Applesoft. In a Applesoft program, an 
inPUT statement changes it to 128 (null). Both of 
these make sense, but youll get six (why six?), if you 
enter the folkiwing 

NEU 

19 PftINT PEEK tSl) 
RUN 

Pauiriix 
Summit ru. 

SlxiswhatendsuplntheYregisterwhenDOS5.5 
searches its command table H>r the word Run -Y is 
used as an index for other table-lookup operations. 
DOS stores this six into the PROMPT tocatkm so that 
the location will later reve^ that a program Is 
executing. When the program ends and fails into 
immediate mode. Applesoft will change PROMfT to 
T (95, $5D) and Integer Bask will change it to > " 
(62,$5E). 

Why six? Itju^ happened to be handy. A more 
logkal value would require more code but sewe no 
purpose other than aesthetics. If you run your test 
program under ProDOS youH fbid a zero there. 

Address sorting 

I operate a small business in whkh I reference all of 
my customers by their street address. I write all of my 
software in Applesoft and have begun to expand the 
versatility of my programs but have a questkm about 
how to sort strings that contain both numbers and 
characters, such as 123 Main Street or 456 Main 
Street and so on. 

There are many sorting routines (both machine 
language and BASIC) that I can use for the actual 
sorting but my efforts to manipulate the street 
address string to sort the street name alphabetically 
and the house numbers in ascending order has not 
been successful. 

Woukl you please discuss the most dHdent way to 
accomplish this? 

OeorgeRolla 
Redwood City, Calif. 

The hask: proNem here seems to be (haf want 
to end UP with your customers sorted by street in 
ascendirig house order. This would be an exceltent 
sortformakingdel^ries,^ example. 
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7?ie only easy way Dennis and I can figure out to 
do this is to keep the house numbers and the streets 
in different strings. Combine the stiing^ u^tn ipu 
want to print someone s address uitth sometMng 
tikeFHJnrm; ":S$(1l 

While this may sound iike a lot of trouble, try ing to 
in^ptemetit a sort routine that can recognize and 
compmaie for numerical values in a string t/iat Is 
b^sortedaiphaibeikMyianavkzuer^ 
to be a real Jo^ Assuming uou adready have tfie 
addresses In a stririg ar?% sfWbng tfiem into a 
mimertcal anaj^ and astrb^ arri^stoitdnY be too 
comptkateid. 

OmxyouhmjethenumbeisandnamesaqmdM 
youcanusejusts^X)utanysoftij^te(M^ 
your database in ftouse number order, dien do a 
bubble " sort to order the street names. Dennis says 
to use a bubble sort (normally disdained for its sloth) 
for the final sort because most faster sorting algo- 
rUhms, mJi as the shell sort wUl saamMe the first 
sonwNkpexfombigtheseamd. 

Double-res files 

Reoently I attempted to move some double-high 
resolution pictures from DOS U to froDOS using 
COflVtini the piGtuies came on the iM Apple 
provided wHh its auxOlaiy^ RQB color card The 
DOS 3 J ffles wore blnaiy and 65 sectors long. TlK 
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process seemed simple but the transfer attempt 
resulted only in a hung system with a bunch of trash 
on the screen and a few clicks of the lie speaker just 
bdore that As usual Apple s no help. 

I am also seeking the locations to poke, or an 6f 
routine, that would allow multi<olor text on my RGB 
saeen when usii^ ProDOS. The only thing i have is 
for DOSUand itdoesn'tM)rk with ProDOS 

Steve Perry 
Santa Ana. Calif 

Dennis trtcd COWEKT on Apple s HOd disk and 
experienced the same problem, then tracked down 
the cause, he saifi (f he worked for Apple, he would 
be embanassed to acknowledge the probkeni too. 

¥/hoeverwn)tetheDOS5^doubk'hl0tftsobitk>n 
demos used a non standard /Ue format for the binary 
IHes holding the piames. SpedjlcaUy, the fourbifes 
at the be0nrdnQofthefbstsedor^Umpies, whkh 
are supposed to hold a t^nary fSe'stoadif^ address 
and length CA" and 1) values, have been omitted. 
The files contain only the data for the picture. The 
programs on the disk use QcLOAD and QtSAVE com- 
mands to access these non-standard files. 

There is nothing in the DOS catalog to indicate to 
COflVZKT that the pie is abnormal. (The programmer 
could have given these files one of the normally 
unused DOS 5.5 file types, for example.) Therefore, 
COMVLKT tries to trar]sfer the file using the information 
in the pie. The fUt hLChAFJ appears to have a 
toadliw ackto$ of imo and a ta^ of$a060 
bffes. COffVm^gi m the afier wpy^ 45 
Mocks. 

CQffVfiRr ends up ^ i%!ping £hioi^ ati me 
softswttcftes In page $CObo (hence the odd Meo 
and^peaterefl^i/ou noted). 77k jto (hat OOm^ 
crashs like this raiher Om repordng m enor does 
not give mu(^ reassurance about COfFVCRTs 
performance. 

Copy II Plus 6.0 can make the conversion without 
bombing; however, the starting address and file 
length are still taken from the erroneous data within 
the file -just as you would expect. The first four 
bytes of the converted picture are missing and all 
other t^ftes are shifted four positions forward, tiot a 
prettyresiM. 

Apple's programmer saued one sector of disk 
space per file by using the spectalstorage technique. 
TherearefiveoftheselUesonViedtskani^sautngof 
ftoesedorsfthediskfastwdtuefreeseCtorslelV.'lhe 
same^fectcouldhavebeenacMeuedbyleailjinQotf 
the last four biftes of the fie. which don't appear on 
the high-resolution screen, anyhoia The price of thb 
misdirected fMc-sfze efficency is the inabittty to 
convert the files back and forth between DOS 5.5 and 
FroDOS. And this is supposed to be Apple's best 
example of how to program doubte-resotutlon 
graphics? 

As far as! can determine, Apple has never officially 
defined how double-resolution files should be stored 
under DOS 5.5; all we have is this rather poor 
example. Beagle Bros spumed it and developed a 
format whereby double-res graphics are stored in 
two files— the main-memory portion in a binary file 
named, for example, PICTURE: the aux-memory 
portion inafiie named PICWRLMiX, Such files are 
reaailutransportabiebetweenDOS5^andProDOS 

WhUe Apple has beoi no help wiOt DOS 5.5, 
PtoDOS technical note ^15 defb^ a standard for 
ProDOS double-high-resolution graphks /Bes. TTiis 
^ndvd uses a special file type caOed POtOfUZ 
(type $08), which was origimHy defined for the 
Apple in. rOTOnils have the awe-memory portion 



of the image in the first $2000 bytes of the file and 
the main-memory portion in the final $2000 bytes. 
In addi^on, byte $73 o/the file holds a code that teUs 
u)hat Mnd of /Be It is. Ifere'sa list of theoodei 

rotor lU graphics m»m com 

\foutti at flls.itart«12t or STB) 

pagt 1 paga 2 

2M M 192 std hlq^-rtM)lutlon • 4 

28e X 192 "limitBd color" 1 5 

S60 X 192 clbl-hlg^ blacW uhitie 2 6 

140 » 192 dbi-high 16-colar 3 ? 

rOTOnils make a poor choicC^or a starKfard, 
however On the Apple //, there is no such thing as a 
page 2 " double-high-resolution picture, so codes 5, 
6, and 7 apply to the Apple III only. The same goes 
for type I 280 x 192 limited color," which never 
appears in Apple U documentation. 

On the other hand, Apple II ROB supports a mbced 
560/140 " mode, for which no fVTOHLE code has 
been defined. This mode is available with RQB 
equipment only. 

Another problem um the FOTOHLE standard Is 
that thegrijphfcs niode code Is stored uii^ the m- 
memorj^ portion of the fUe for doubte-resoMkm 
grapMci hut^thernatn-iriemofyportion^sCandwd 
high-resoiuffon /Bes. (f the main-memory portion of 
the graphic umatthe beginning of the file, whh the 
graphic-mode code embedded within it you could 
load that portion directly into memory, then look at 
the code to see if there was an additional portion to 
go into aiu memory. here's a simple example of 
how such a file would be loaded under ProDOS, 
using a file type I just made up and called PIO 

im poke: 49153.0 : REr B0S'GRe on 
mS POKE 4S239.0 : REf- ^IQZS on 
1010 POKE 49236,0 : RE^ PAGE2 gff 
ia2t PRINT DI;-aO« paUviM. ni92, LB192» TPIC 
1131 T«PCCK(B192n2l} : REM gtt aodi coda 
im IT T*(itd nt graphic coda) THEN IIM 
1051 POCC 49237,1 : ROt mGC2 on 
:m PRINT DS:-a(M) pathmM. mi92, L8192, BB192. 
TPIC- 

1071 POKE 4923S.» : REH PRQE2 off 

10ei ON T GOTO .... : REH flip R68 MltchM for Htfo 

Using rOTOHLEs. you either have to load the first 
part of the file in matn-memory and then mooe or 
reload it into aux mmory (f the picture turns out to 
be douMe-resobittoa or you haue to load the first 
part Into aur-memory and moue it to main (fit turns 
out to single-resolution. Cbme oa Apple— how 
aboutanewfiietypeiuslfbrAppkllgraiikfll^ 

Apple's treatment of douMe-hlgh resolutoi In 
terms of documentation and support has been 
shoddy since day 1 (One of many examples- 
memory maps in the A^e mantml all show a 
high-res graphics page 2 in auxiliary memory, even 
though there isnt such a thing. ' There is no more 
obscure arena in the Apple II aorid than double- 
resolution. Apple has indicated that advanced color 
graphics will be a part of the next Apple II -let's 
hope they get their act together better this time or 
programmers will be too confused to use them. 

Oh. and speaking of confusion, does your question 
about multi<olored text refer to the green-amber- 
blue-white choice for text screens, to AO-column, 16- 
color foreground l&color background text: or to 
colored text on the douUe-high-rtsolution screen? 
ACbiaByU makes me dttfefence-^thesuMc^ 
ail these thb^ are the same whether you 're uslr^ 
m>OOS or DOS 3J. ft>r euerything I know about 
im see the May 1965 Open Apple, pa^es 55 and 
56, ar^lheJulyl965b^e, page 54. 



